home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / MDF120.ZIP;1 / MDF_ENG.DOC < prev    next >
Encoding:
Text File  |  1994-03-07  |  9.7 KB  |  365 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   MDIFF  -  MPATCH
  14.  
  15.                                     Release  1.20
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.            A simply and complete software to produce and apply patches to
  30.                             your programs and data files.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    English manual.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                   (C) 1994/95 Maurizio Giunti - All rights reserved
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.          1.INDEX
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.          1.INDEX ..................................................2
  71.  
  72.          2.WHY ? ..................................................3
  73.  
  74.          3.WHAT MDIFF-MPATCH DOES ? ...............................3
  75.  
  76.          4.DOS AND OS/2 ...........................................3
  77.  
  78.          5.LIMITS .................................................3
  79.  
  80.          6.MDIFF - MDIFF2 .........................................3
  81.  
  82.          7.MPATCH - MPATCH2 .......................................4
  83.  
  84.          8.ADVICES ................................................4
  85.  
  86.          9.RIGHTS .................................................5
  87.  
  88.          10.WARRANTY ..............................................5
  89.  
  90.          11.HOW TO REGISTER .......................................5
  91.  
  92.          12.ACKNOWLEDGEMENTS ......................................6
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 2 -
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.          2.WHY ?
  126.          Some week ago I had to release a new version of a program written
  127.          by me: the compressed packet was about 200 KBytes,  and I thought
  128.          that it was better to update the old version of  the program with
  129.          a patch.I looked for patch makers/appliers programs but I did not
  130.          find any software  that satisfied  me. Moreover I  did'nt find  a
  131.          software that runs both under Dos and OS/2 2.xx.
  132.          I decided to make my own patch software and.....here it is ! 8-)
  133.  
  134.  
  135.  
  136.          3.WHAT MDIFF-MPATCH DOES ?
  137.  
  138.          MDIFF creates a binary difference between two  files. With MPATCH
  139.          and the older file  you can create the  newer file using  the the
  140.          difference file.  Where  is the  advantage  ? Easy:  usually  the
  141.          difference file is  smaller than newer  file, so it's  convenient
  142.          distribute it, expecially by modem.
  143.  
  144.  
  145.  
  146.          4.DOS AND OS/2
  147.  
  148.          In the distribution  packet you will  find 4 executable  files, 2
  149.          for Dos  and  2  for  OS/2  2.xx. There  are  no  differences  in
  150.          functions and usage of  the different versions.  Difference files
  151.          produced with MDIFF for Dos can be used with MPATCH for OS/2 2.xx
  152.          and vice-versa.
  153.  
  154.  
  155.  
  156.          5.LIMITS
  157.  
  158.          MDIFF can't work on files greater than 16  Mbytes. Moreover MDIFF
  159.          Dos version can't work on files  greater than the amount  of free
  160.          conventional memory of the  system. OS/2 version, thanks  to OS/2
  161.          flat memory model, is not affected by this limitation.
  162.  
  163.  
  164.  
  165.          6.MDIFF - MDIFF2
  166.  
  167.          MDIFF compares 2 files and stores the differences between them in
  168.          a difference file. This is the command line syntax:
  169.  
  170.                 MDIFF [-C<c>] [-R<r>] <OldFile> <NewFile> [<MDFfile>]
  171.  
  172.          <OldFile> is the name of the older file, <NewFile> is the name of
  173.          the newer  file. If  you wish  you can  specify the  name of  the
  174.          difference file  that MDIFF  will produce,  otherwise MDIFF  will
  175.          create a  file with  the name  of  the newer  file  but with  the
  176.          extension ".MDF".
  177.          To search differences between files,  MDIFF use a base  string of
  178.          defined lenght named  Chunk. The  Chunk lenght is  by default  16
  179.  
  180.  
  181.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 3 -
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.          bytes, but you  can change it,  in the range  4-256, with the  -C
  189.          switch followed by the desired lenght.
  190.          When MDIFF  loses the  synchronism between  the  two files  being
  191.          compared,  it  scans  the   older  file  searching   the  current
  192.          chunk.This scansion  is executed,  by default,  in a  range of  8
  193.          blocks of 512 bytes each. You can change the number of the blocks
  194.          scanned, in the range  1-16, with the  -R switch followed  by the
  195.          desired number of blocks.
  196.          If this  search  fails,  MDIFF  tries  to  force  synchronization
  197.          through a large range  search. This range  is defined as  1/16 of
  198.          the old  file  lenght.  The  second  search can  be  disabled  by
  199.          specifying -F switch on the command line.
  200.          If you  specify -S  switch, MDIFF  will  output some  information
  201.          about the composition of the diff file.
  202.  
  203.  
  204.  
  205.          7.MPATCH - MPATCH2
  206.  
  207.          With the old file and the .MDF file you can rebuild  the new file
  208.          running MPATCH. This is the command line syntax:
  209.  
  210.                       MPATCH <MDFfile> [<OldFile>] [<NewFile>]
  211.  
  212.          MPATCH needs only the name of the mdf file (<MDFfile>) because it
  213.          contains the names  of the other  2 files,  but it's possible  to
  214.          override these names  by simply specifying  the desired names  on
  215.          the command line. MPATCH does not have any switches.
  216.  
  217.  
  218.  
  219.          8.ADVICES
  220.  
  221.          The best method  to build  a difference  file, is  to search  the
  222.          chunks of the newer file in the entire older file, but  this is a
  223.          very slow way to do !
  224.          MDIFF's algorithm tries to give a  small diff file in  the faster
  225.          way; so you  are sometimes required  to tune the  work parameters
  226.          with the command line switches.
  227.          Let's look some tipical situations:
  228.          1. Very similar  files: use  a large  chunk (32,  64 or  more) to
  229.             reduce the size of the diff file.
  230.          2. Text files: try  to use a  chunk size  of 32,  sometimes it is
  231.             better to turn the forced sync off, with the -F switch.
  232.          3. Very large executable: try to use a larger resync range (16 or
  233.             more), with the -R switch.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 4 -
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.          9.RIGHTS
  252.  
  253.          This software belongs to Shareware programs: anyone can freely
  254.          distribute and use it for a trial period of 15 days. After this
  255.          period, users that continue to use it must register their copy by
  256.          sending the registration fee to the author, Maurizio Giunti.
  257.          Users that get registered will receive a "registration key".
  258.          Anyone can re-distribute this software, but only if he/she asks
  259.          back no money, except for copy and/or shipping expenses (anyway,
  260.          these expenses must be carefully documented). Another condition
  261.          that you must follow to distribute it, is to furnish the ORIGINAL
  262.          packet always, without any modifications to the program and/or
  263.          documentation.
  264.          There  is  an  exception:  you  can   distribute  MPATCH.EXE  (or
  265.          MPATCH2.EXE) with  one  or  more  *.MDF  files  produced  with  a
  266.          REGISTERED copy of MDIFF.
  267.  
  268.  
  269.  
  270.          10.WARRANTY
  271.  
  272.          The only warranty that comes with  this software is that  it will
  273.          occupy disk space. I absolutely can NOT warrant you  that it will
  274.          perfectly work, or that it will be your problems' resolution.
  275.          Nevertheless, I  am sure  that it  is not  a virus  and does  not
  276.          contain (unless  infected  or  modified  after  the  compilation)
  277.          Trojan-horses, backdoors and similar tricky garbage. In any case,
  278.          the author is not responsible for any damage,  moral or material,
  279.          direct or indirect, derived from its usage.
  280.  
  281.  
  282.  
  283.          11.HOW TO REGISTER
  284.  
  285.          The individual registration key  costs 15,000 Italian  Lire. Site
  286.          licenses available on request. The key is valid for  both Dos and
  287.          OS/2 version of the software. Add  to this cost the  expenses for
  288.          key sending, that  is 1,000  Lire for  Italy and  2,000 Lire  for
  289.          other countries. The registration key will  be sent via mail, but
  290.          if explicitly required, it  can be also  sent via FAX,  for Italy
  291.          only. The fee should be paid  using a postal order (in  Italy) or
  292.          an international postal order in Italian Lire from outside (check
  293.          with your  local post  office),  payable to  the  post office  of
  294.          FIRENZE. The addressee of the order must be the following:
  295.  
  296.                                    Maurizio Giunti
  297.                                 Via G.B. Foggini, 24
  298.                                  50142 Firenze (FI)
  299.                                         ITALY
  300.  
  301.          It  is better  to indicate on the  order the name of  the program
  302.          you want  to register, your  name, address and FAX  number (where
  303.          required). For  short notes,  use the  appropriate  space on  the
  304.          postal order (if present), or at  best send a Netmail  message to
  305.          Maurizio Giunti on 2:332/102.3 at Fidonet.
  306.  
  307.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 5 -
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.          12.ACKNOWLEDGEMENTS
  318.  
  319.          I'd like to  shortly thanks all  those who  helped me to  develop
  320.          this software and its documentation  and all those who  helped me
  321.          in beta-testing. In alphabetical order:
  322.  
  323.                                     Silvia Borri
  324.                                     Filippo Dini
  325.                                  Fabrizio Fioravanti
  326.                                  Cristiano Guidoccio
  327.                                 Giovanni Lopes Pegna
  328.                                   Marco Maccaferri
  329.                                    Giuseppe Scarpi
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 6 -
  371.